home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / rap11.zip / RAP.DOC < prev    next >
Text File  |  1993-07-08  |  8KB  |  175 lines
  1.                              Rap version 1.1
  2.  
  3.                  Copyright (C) 1992, 1993 by Thomas M. Roddy
  4.                             All Rights Reserved.
  5.  
  6.  
  7. Introduction:
  8.  
  9. Rap is a "word wrap" utility program which is used to reformat a text file
  10. into specified line lengths without splitting up words across lines. If a
  11. word will not fit at the end of a line, then the entire word will start
  12. the next line. This differs from programs which reformat text files to a
  13. given line length regardless of the word boundaries.
  14.  
  15. The shareware version of Rap is restricted in one way. To encourage
  16. registration, it will only process the first 30000 or so characters of a file.
  17. This should be adequate to test the usefulness of the program. Please
  18. register if you find Rap useful. You will be mailed the latest version of
  19. the program without the shareware notice and with the restriction removed.
  20.  
  21.  
  22. License and distribution information:
  23.  
  24. Rap is shareware. It is not public domain or free software. An order form
  25. is enclosed in the file named ORDER.FRM.  After trying it out for 14 days, if
  26. you like it and want to continue using it, please register by sending the
  27. registration fee (located in ORDER.FRM) with your name and address along with
  28. any comments or questions to the address listed.
  29.  
  30. You may NOT alter the code nor may you sell this program or any of its
  31. associated data files for any price.  You may charge a reasonable copy
  32. fee of not more than US$10 when distributing it to others as long as you
  33. clearly stipulate that Rap must be registered with its author if it is
  34. used beyond the trial period. Every copy of the ZIP distribution file
  35. must contain all of the files listed below.
  36.  
  37. You may (and are encouraged to) distribute the shareware version of Rap
  38. to others. Under no circumstances may you distribute a registered version
  39. of Rap to others.
  40.  
  41.  
  42. Disclaimer:
  43.  
  44. The author makes no claims or guarantees about the use of Rap and will
  45. not be responsible for any loss of data or profits due its use or misuse.
  46.  
  47.  
  48. Compatibility:
  49.  
  50. Rap should work with all standard ASCII files. It has not been tested with
  51. files containing control characters commonly found in documents in specific
  52. word processing formats such as Word Perfect or Microsoft Word. Most
  53. word processors allow you to convert documents to ASCII format. You should
  54. do this before using Rap on the documents.
  55.  
  56. Rap should work with UNIX generated files which may have line feeds
  57. without the accompanying carriage returns generally found in MS-DOS
  58. generated files. It should also work with Macintosh generated files.
  59. The output file generated by Rap will, however, have a carriage return
  60. and line feed at the end of each line.
  61.  
  62.  
  63. Files in distribution:
  64.  
  65.  RAP.EXE    -   Rap executable program
  66.  RAP.DOC    -   This file - Documentation for Rap
  67.  ORDER.FRM  -   Printable order form for registering Rap
  68.  
  69.  
  70. Product description:
  71.  
  72. Rap will "word wrap" lines of text to fit into the line width specified
  73. on the command line. If a full word cannot fit on the end of one line,
  74. the entire word is wrapped to the next line. Rap will not hypenate words
  75. that are not already hypenated, but will unhyphenate words that are hyphen-
  76. ated at the end of a line (as in the above line) since the hyphenation is
  77. meaningless (actually confusing and incorrect) if it appears in the middle
  78. of a line after being reformatted by Rap.
  79.  
  80. If a line width is not specified, then Rap will default to the largest line
  81. width it supports which is 2147483647 characters per line. This effectively
  82. removes all line breaks within a paragraph. Acceptable values are from 10 to
  83. 2147483647 and can be specified using the /W option.
  84.  
  85. Rap also allows you to specify the size of the two internal buffers which
  86. are used in processing the file. The default sizes for the two buffers are
  87. 2048 bytes each. You can modify this value by using the /B option. Acceptable
  88. values are from 128 to 30208 bytes. If performance is critical, you could
  89. optimize the processing time by setting these buffer sizes, but in my testing
  90. 2048 bytes seems to be the most efficient value.
  91.  
  92. Specifying the output file name is optional.  If no output file name is given,
  93. the output file name will default to the input file name with the extension
  94. .RAP appended to it.  For example, the input file TEXTFILE would default to
  95. the output file TEXTFILE.RAP while TEXTFILE.TXT would also default to
  96. TEXTFILE.RAP.  Rap will error if the input file has the same name as the
  97. output file.
  98.  
  99. Many word processing programs reformat paragraphs themselves depending
  100. on how many characters can fit on a line. This is frequently dependent
  101. upon font size, margins, etc. By removing the "line breaks", these programs
  102. can process the file better because they don't have to worry about "line
  103. breaks" which are already in the file. Rap is therefore very useful when
  104. converting documents between different word processors. In some cases, you
  105. may want to put in line breaks after 80 characters, while other times you
  106. may want to strip out all the line breaks within a paragraph and let the
  107. word processor do the reformatting.
  108.  
  109. Most word processor programs save their files in a proprietary format with
  110. control characters. If the text file is not in ASCII format, you must convert
  111. it to ASCII. Most word processors allow you to do this.
  112.  
  113. Reformatting documents using word wrap programs often have undesirable side
  114. effects so this type of text processing is dependent upon the text files you
  115. want to print.
  116.  
  117. Usage:  Rap infile [-Wm] [-Bn] [outfile]
  118.  
  119.    where m is the desired line width:
  120.          minimum=10, maximum=2147483647, default=2147483647
  121.    where n is the desired buffer size
  122.          minimum=128, maximum=30208, default=2048
  123.  
  124.  
  125. Examples:
  126.  
  127.     RAP TEXTFILE.TXT /W76
  128.           Reformats TEXTFILE.TXT into 76 characters per line and writes
  129.           it to TEXTFILE.RAP
  130.  
  131.     RAP TEXTFILE.TXT
  132.           Reformats TEXTFILE.TXT into 2147483647 characters per line and
  133.           writes it to TEXTFILE.RAP. This effectively removes all line breaks
  134.           within paragraphs. Useful for importing the document to word
  135.           processors which do not like line breaks.
  136.  
  137.     RAP TEXTFILE.TXT /W50
  138.           Reformats TEXTFILE.TXT into 50 characters per line and writes
  139.           it to TEXTFILE.RAP. This is useful for printing the output file
  140.           in three columns (using ColPrint) on a printer that supports 160
  141.           characters per line (20 cpi) mode.
  142.  
  143.     RAP TEXTFILE.TXT /W50 /B8096 TEXT2.TXT
  144.           Reformats TEXTFILE.TXT into 50 characters per line and writes
  145.           it to TEXT2.TXT. The two internal buffers are each 8 KB in
  146.           size.
  147.  
  148. RAP.EXE should be placed in a directory which is in your search PATH so that
  149. you can run the program from within other directories.
  150.  
  151.  
  152. Miscellaneous information:
  153.  
  154. Warning: you are not legally allowed to modify many copyrighted software
  155. manuals. This program should be used on your own personal files or with the
  156. permission of the document's author.
  157.  
  158. If you are looking for a printing program to print your files into newspaper
  159. style columns, take a look at another shareware program by this author called
  160. ColPrint. ColPrint is compatible with many dot matrix, DeskJet, and laser
  161. printers. If you can't find it on your local BBS, download it from CompuServe.
  162. If you do not have access to CompuServe, send $5 to the address below and I'll
  163. mail you a Shareware copy to evaluate or send $9.95 + $1 (shipping/handling)
  164. for a registered unrestricted version.
  165.  
  166. The author can be contacted by US mail or CompuServe:
  167.  
  168.  Thomas M. Roddy              CompuServe ID:  73730,3304
  169.  7158 Harp String
  170.  Columbia, MD  21045
  171.  
  172.  
  173. Trademarks are the property of their respective owners.
  174.  
  175.